package org.convallaria.system.biz.service.sys;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import jakarta.servlet.http.HttpServletResponse;
import org.convallaria.system.biz.entity.SysUser;
import org.convallaria.system.biz.entity.dto.sys.ChangePwdDTO;
import org.convallaria.system.biz.entity.dto.sys.ResetPwdDTO;
import org.convallaria.system.biz.entity.dto.sys.UserCreateDTO;
import org.convallaria.system.biz.entity.dto.sys.UserProfileDTO;
import org.convallaria.system.biz.entity.dto.sys.UserQuery;
import org.convallaria.system.biz.entity.dto.sys.UserUpdateDTO;
import org.convallaria.system.biz.entity.vo.sys.UserVO;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;
import java.util.Set;

/**
 * 系统用户服务接口
 * 
 * @author gjh
 * @since 2024-09-22
 */
public interface SysUserService extends IService<SysUser> {

    /**
     * 分页查询用户列表（包含部门信息）
     *
     * @param query
     * @return
     */
    IPage<UserVO> pageUsers(UserQuery query);

    /**
     * 获取用户详情信息
     *
     * @param userId 用户ID
     * @return 用户详情信息
     */
    UserVO getDetail(Long userId);

    /**
     * 新增用户
     *
     * @param userDTO
     */
    void addUser(UserCreateDTO userDTO);

    /**
     * 修改用户
     *
     * @param userDTO
     */
    void editUser(UserUpdateDTO userDTO);

    /**
     * 批量删除用户（清除相关缓存）
     *
     * @param userIds 用户ID列表
     * @return 是否成功
     */
    boolean deleteUsers(List<Long> userIds);

    /**
     * 重置用户密码
     *
     * @param resetPwdDTO
     */
    void resetPwd(ResetPwdDTO resetPwdDTO);

    /**
     * 修改密码
     *
     * @param changePwdDTO
     */
    void changePwd(ChangePwdDTO changePwdDTO);

    /**
     * 更新用户信息
     *
     * @param userProfileDTO
     */
    void updateProfile(UserProfileDTO userProfileDTO);

    /**
     * 上传用户头像
     *
     * @param file 文件
     * @return 头像URL
     */
    String uploadAvatar(MultipartFile file);

    /**
     * 导出用户列表
     *
     * @param query 查询条件
     * @param response 响应对象
     */
    void exportUsers(UserQuery query, HttpServletResponse response);

    /**
     * 下载用户导入模板
     *
     * @param response
     */
    void downloadTemplate(HttpServletResponse response);

    /**
     * 导入用户
     *
     * @param file
     * @return
     */
    void importUsers(MultipartFile file);
    
    /**
     * 根据用户ID获取用户信息（带缓存）
     * 
     * @param userId 用户ID
     * @return 用户信息
     */
    SysUser getUserById(Long userId);
    
    /**
     * 更新用户信息（清除相关缓存）
     * 
     * @param user 用户信息
     * @return 是否成功
     */
    boolean updateUser(SysUser user);
    
    /**
     * 删除用户（清除相关缓存）
     * 
     * @param userId 用户ID
     * @return 是否成功
     */
    boolean deleteUser(Long userId);
    
    /**
     * 刷新用户缓存
     * 
     * @param user 用户信息
     * @return 用户信息
     */
    SysUser refreshUserCache(SysUser user);
    
    /**
     * 获取用户角色
     * 
     * @param userId 用户ID
     * @return 角色集合
     */
    Set<String> getUserRoles(Long userId);
    
    /**
     * 获取用户权限
     * 
     * @param userId 用户ID
     * @return 权限集合
     */
    Set<String> getUserPermissions(Long userId);

    /**
     * 根据用户名获取用户信息
     * 
     * @param username 用户名
     * @return 用户信息
     */
    SysUser selectByUsername(String username);

    /**
     * 根据用户名和租户ID获取用户信息
     * 
     * @param username 用户名
     * @param tenantId 租户ID
     * @return 用户信息
     */
    SysUser selectByUsernameAndTenant(String username, Long tenantId);

    /**
     * 验证用户密码
     * 
     * @param userId 用户ID
     * @param password 密码
     * @return 是否匹配
     */
    boolean validatePassword(Long userId, String password);

    /**
     * 检查用户状态是否正常
     * 
     * @param userId 用户ID
     * @return 是否正常
     */
    boolean isUserStatusNormal(Long userId);

    /**
     * 更新用户最后登录信息
     * 
     * @param userId 用户ID
     * @param loginIp 登录IP
     * @return 是否成功
     */
    boolean updateLastLoginInfo(Long userId, String loginIp);

    /**
     * 获取用户的部门信息
     * 
     * @param userId 用户ID
     * @return 部门信息
     */
    Object getUserDeptInfo(Long userId);

    /**
     * 获取用户的岗位信息
     * 
     * @param userId 用户ID
     * @return 岗位信息列表
     */
    List<Object> getUserPostInfo(Long userId);

    /**
     * 获取用户的完整信息（包含角色、权限、部门、岗位）
     * 
     * @param userId 用户ID
     * @return 用户完整信息
     */
    Object getUserCompleteInfo(Long userId);

    /**
     * 检查用户名是否唯一
     * 
     * @param username 用户名
     * @param userId 用户ID（更新时排除自己）
     * @param tenantId 租户ID
     * @return 是否唯一
     */
    boolean isUsernameUnique(String username, Long userId, Long tenantId);

    /**
     * 检查邮箱是否唯一
     * 
     * @param email 邮箱
     * @param userId 用户ID（更新时排除自己）
     * @param tenantId 租户ID
     * @return 是否唯一
     */
    boolean isEmailUnique(String email, Long userId, Long tenantId);

    /**
     * 检查手机号是否唯一
     * 
     * @param phoneNumber 手机号
     * @param userId 用户ID（更新时排除自己）
     * @param tenantId 租户ID
     * @return 是否唯一
     */
    boolean isPhoneNumberUnique(String phoneNumber, Long userId, Long tenantId);
}
